home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_1 / jail500.zip / JAIL.DOC < prev    next >
Text File  |  1991-06-29  |  18KB  |  593 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.                  ┌────────────────────────────────────────────┐
  15.                  │                                            │
  16.                  │                  JAIL BREAK!               │
  17.                  │            ======================          │
  18.                  │                                            │
  19.                  │       A Live Game for Many BBS Formats     │
  20.                  │                                            │
  21.                  │   Game Release Version 3.0 - 01/01/91      │
  22.                  │                                            │
  23.                  │             (C)opyright 1990               │
  24.                  │                                            │
  25.                  │                   By                       │
  26.                  │                                            │
  27.                  │            SECRET SERVICE BBS              │
  28.                  │                                            │
  29.                  │              Mike Wilson                   │
  30.                  │            P.O. Box 9521                   │
  31.                  │            Huntington, WV                  │
  32.                  │                  25704                     │
  33.                  │                                            │
  34.                  │            BBS (304) 429-6838              │
  35.                  │           1200/2400/9600  24 hrs.          │
  36.                  │                                            │
  37.                  │                                            │
  38.                  │                                            │
  39.                  │                                            │
  40.                  └────────────────────────────────────────────┘
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.                      JAIL BREAK!  (C)opyright 1990 - Page 1
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.                                   Warranty
  77.  
  78.  
  79. This is product is provided "as is" without warranty of any kind.  The
  80. entire risk as to the results and performance of the program is assumed by
  81. you. Futher more, I the author do not warrant, guarantee, or make any
  82. representations regarding the use of, or the results of the use of the program,
  83. and you rely on the program and results solely at your own risk.  I the author
  84. cannot accept responsibility for system damage, loss of profit, or any other
  85. special, incidental, or consequential damages resulting from the use or
  86. inability to use this product.
  87.  
  88.  
  89.                                  Copyright
  90.  
  91.  
  92. The Multi-Board JAIL BREAK! live game is distributed as SHAREWARE.
  93. Under this concept you may use the SHAREWARE (unregistered) version for a
  94. reasonable period of time, which I consider to be three weeks, after which you
  95. must either register your copy or discontinue usage.
  96.  
  97.  
  98.                                Registration
  99.  
  100. With registration you will recieve the latest registered copy of JAIL BREAK!
  101. with the ability to download any futher updates from Secret Service BBS
  102. at no extra cost. You will also recieve any support the author can give
  103. in reference to bugs or other problems that may arise in using the game.
  104.  
  105. I feel that sysop's have enough expense without charging a high cost for a game
  106. for their users. I have set the cost of registration at $20.00 which I feel
  107. if people will follow the shareware concept will be enough to cover shipping
  108. and handling and encourage me to write more doors.
  109. See registration form called Register.txt in the .zip file for ordering!
  110.  
  111.                                Distribution
  112.  
  113. You are free, in fact encouraged, to distribute the SHAREWARE (unregistered)
  114. version of Multi-board JAIL BREAK! Live Game provided that all files
  115. contained in the original JAIL BREAK! archive are distributed in their
  116. original unmodified state.
  117.  
  118. EXPIRATION
  119. ----------
  120. This game in demo form will expire. The date of expiration will appear
  121. at the bottom of the screen when you run the game in any mode.
  122. If you receive a .zip which contains an expired jail.key you may
  123. download a new .key from the Secret Service without need to waste
  124. download time on the entire .zip.  The file is called Newkeys.zip and
  125. can be downloaded without need for validation. (304) 429-6838
  126. You may always Demo the door in local mode by typing: JAIL LOCAL
  127. from the command line (after you have JAIL SETUP on a command line).
  128.  
  129.  
  130.  
  131.  
  132.                    JAIL BREAK!  (C)opyright 1990 - Page 2
  133.  
  134.                                Introduction
  135.                                      &
  136.                                 How To Play
  137.  
  138. Jail Break! allows users to move around within a 1000 cell prison and try to
  139. establish businesses, buy warriors, buy weapons, and establish a prison
  140. empire.  During their journey they will encounter such things as bombs, guards,
  141. and other prisoners which will try to set them back.  Players compete until
  142. the sysop resets the game (usually 4 to 6 months).
  143.  
  144.                           Options and Information
  145.  
  146. This door game will also create color and mono top 10 bulletins and write them
  147. in directories of your choice written in the bulletin.cfg file.
  148. The game will support coms 1 - 4 at speeds of 115200 locked baud.
  149.  
  150.                             Installation and Setup
  151.  
  152. FIRST RUN THE SETUP PROGRAM! THIS WILL CREATE THE 1000 CELL JAIL!
  153. TYPE:  JAIL SETUP  and then press the <ENTER> key.
  154. The program should be run this way the first time you install the door
  155. or any time you wish to reset the game.  The first screen of the
  156. setup program asks if you wish to create the files necessary for the
  157. game. Answer Y for first time setup or if you wish to reset scores.
  158. The next screen will ask you for the type of Bulletin Board Software
  159. that you are running. Choose the one that fits your needs.
  160. The next screen will ask if you wish to configure the game.  Answer
  161. Y for first time setup and answer the questions that are asked.
  162. The fourth screen will allow you to create your bulletin.cfg file which
  163. contains the paths to your color and mono bulletins. Answer "Y" if you
  164. wish the setup program to create this file for you.
  165. The fifth screen you must answer Y to to allow it to make the Jail Cells.
  166.  
  167. After you finish with Setup then create  a batch file to call the
  168. game from within the board (as described below). Your ready to go!
  169.  
  170. The following is a listing of each file that created by Setup.exe
  171. and by makejail.exe.
  172.  
  173. ** If you are running multi-nodes then you must use an ASCII word
  174. processor or Copy Con to create .cfg files for each node as
  175. described below.
  176.  
  177. JAIL.CFG contains:
  178.  
  179. The Secret Service BBS           <-- Name of BBS
  180. Mike                             <-- Sysop's first name
  181. Wilson                           <-- Sysop's last name
  182. C:\path\bbsfile.xxx          <-- Path and filename for board info file
  183. NO                               <-- NO or locked COM PORT Baud Rate
  184. 150                              <-- Number of turns a player gets per day
  185. 20                               <-- Number of minutes a player gets per day
  186.  
  187. The path and filename for the bbsfile refers to whatever file your
  188. board software creates. The following are the correct file for each
  189. board.
  190. Wildcat prior to V3.0 ---> Callinfo.bbs   Spitfire --> SFDOORS.DAT
  191. GAP or WILDCAT V. 3.0+ --> Door.sys       PCBoard ---> PCBoard.sys
  192. QuickBBS --> DorinfoX.def (The X will be a 1 or a 2 depending on node #)
  193.  
  194.  
  195. An example of a correct line would be: C:\Wildcat\callinfo.bbs
  196.  
  197.                JAIL BREAK!  (C)opyright 1990     Page - 3
  198.  
  199.  
  200. NOTE FOR MULTI NODES!
  201. You may now have several .cfg files to allow use on multinode systems.
  202. Use the above .cfg format but name each .cfg file differently. You
  203. may call them what you want as long as you correctly call them from
  204. the batch file command line.
  205.  
  206. Example:    Node1:     game game.cfg
  207.  
  208.             Node2:     game game1.cfg
  209.  
  210.  
  211. The setup.exe file will create only one .cfg file titled
  212. JAIL.cfg.  You must make the second, third, etc .cfgs
  213. with a standard ascii word processor or the use of Copy Con
  214. from dos.
  215.  
  216. *** This game supports non-standard Port Address and IRQ's required
  217.     on many multi-node systems! Read the file PORT.DOC if you NEED
  218.     to alter the Com specs for your particular board setup!
  219.     Don't worry about it if your running normal ports 1 - 4!
  220.  
  221. BOARD.TXT
  222. This file is created by the Setup.exe program. This file tells the game
  223. what board the game is running on. The game defaults to Wildcat! if there
  224. is no Board.txt file found.
  225. If your running the following boards, board text should contain one line
  226. with one of the following on it:
  227. For QuickBBS ----> QBBS
  228. For PCBoard -----> PCB
  229. For GAP or WILDCAT 3.0+ ---------> GAP
  230. For Spitfire ----> SPITFIRE
  231. For Wildcat prior to V3.0 -----> NO board.txt file in the directory
  232. You don't have to worry about this file if you run Setup and choose the
  233. board you wish to use, it creates the file for you.
  234.  
  235. BREAK.DAT contains:
  236.  
  237. This file contains the following user data:
  238.  
  239. "SYSOP","11-10-1989","N"," 10"," 0"," 0"
  240.  
  241. Data has to be kept in this format.
  242.  
  243. JAIL.DAT contains:
  244.  
  245. The entire 1000 sector jail.  Do not alter it!
  246.  
  247. BULLETIN.CFG contains:
  248. This file is used with bulletin.exe to show where you want the top ten
  249. bulletins placed and what you want to call them.
  250. The format for this file is:
  251.  
  252. C:\Path\Color.SCR  <-- Path and Name of COLOR bulletin
  253. C:\Path\Mono.BBS   <-- Path and Name of ASCII Bulletin
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.               JAIL BREAK  (C)opyright 1990    Page - 4
  264.  
  265.  
  266. JAIL.TXT contains:
  267.  
  268. This is the instruction file for JAIL BREAK!. When a user selects the
  269. Instructions option during the game, this file is read for
  270. instructions. This file MUST BE PRESENT and Not altered in any way for
  271. JAIL BREAK! to run properly
  272.  
  273. JAIL.NEW
  274.  
  275. This is the JAIL BREAK News file.  It is created by the setup program
  276. and is displayed when a user chooses read news within the game.
  277.  
  278.  
  279. MAINT.EXE
  280.  
  281. This file maintains the JAIL.new News file, move the guards around, move the
  282. weapons around, causes the businesses to generate profit, etc.You should run
  283. this DAILY.  Set it up to be run from an external event!
  284.  
  285.  
  286. MAIL.TXT
  287.  
  288. This file contains the public mail users send and receive.
  289.  
  290.  
  291.                           List of Files In Archive
  292.  
  293.  
  294. The following files are either found in your JAIL BREAK! Zip or will be
  295. created during the runtime execution of the game or Setup.exe.
  296.  
  297.  
  298. BULLETIN.EXE <-- Generates the color and monor bulletins for the game
  299.  
  300. Bulletin.cfg # <-- Configuration file for bulletin .exe
  301.  
  302. MAINT.EXE  <-- Maintenance program for the game
  303.  
  304. JAIL.EXE    <--- Executable Program.
  305.  
  306. JAIL.CFG   #<--- Configuration File.
  307.  
  308. JAIL.DAT   #<--- Store User's Name, Last Play Date & Score.
  309.  
  310. JAIL.TXT    <--- Instructions Used By Program.
  311.  
  312. BULLET##.SCR *<--- COLOR Bulletin
  313.  
  314. BULLET##.BBS *<--- MONO Bulletin
  315.  
  316. JAIL.new   #<--- News file
  317.  
  318. Mail.txt  <-- Mail text file
  319.  
  320. Port.Doc  <--- Read ONLY if you are using non-standard port addresses
  321.  
  322. JAIL.DOC    <--- This File.
  323.  
  324.  
  325. * DENOTES that file is created by bulletin.exe
  326. # DENOTES files which are created during run of Setup.exe
  327.  
  328.  
  329.                 JAIL BREAK (C)opyright 1990  Page - 5
  330.  
  331.                                   Batch Files
  332.                                =================
  333.  
  334. Be sure that you have edited or created the JAIL.CFG file with the correct
  335. information as described earlier in these docs. The individual setups do not
  336. repeat this necessary process.
  337.  
  338.  
  339.  
  340. Wildcat! 1.13 & 2.5+ Setup:
  341. ---------------------------
  342. First, create your DOOR##.BAT (2.0+) or LIVE##.BAT (1.13) like this eample:
  343.  
  344.    ECHO OFF
  345.    CD \WILDCAT\DOORS\JAIL
  346.    JAIL JAIL.CFG
  347.    BULLETIN BULLETIN.CFG
  348.    CD \WILDCAT
  349.    CAT.BAT
  350.  
  351. place this batch file in your Node# directory if running Multi-Nodes or in
  352. your Wildcat (default) directory if single node.
  353.  
  354. Second, Create a sub-directory for the door program such as in the following
  355. example:
  356.  
  357. C:\WILDCAT\DOORS\JAIL
  358.  
  359. Third, put the Jail Break game files in the \WILDCAT\DOORS\JAIL directory.
  360.  
  361. Forth, add this game to your live program menu for user selection and your
  362. ready to run the door.
  363.  
  364. If this is a little unclear then please read your systems documentation for
  365. more detailed instructions.
  366.  
  367. If you use a door monitoring program then read their documentation for
  368. their specific setup.
  369.  
  370.  
  371.  
  372.  
  373. Gap Setup:
  374. ----------
  375. First, add the number and name of the door to your menu. This will allow the
  376. user to select the door by number.
  377.  
  378. Second, edit or create the file called DOORS.DAT which is normally in the GEN
  379. directory. Following is an example line to add:
  380.  
  381.    JB 10
  382.  
  383. where 'JB' stands for the name of the batch file (shown below) to invoke the
  384. the door and '10' is the required security level.
  385.  
  386. Third, create a sub-directory for Jail Break to be placed in. And example
  387. would be:
  388.  
  389. C:\GAP\JAIL
  390.  
  391. place all the files in the JAIL.ZIP archive inside this directory.
  392.  
  393.  
  394.  
  395.              JAIL BREAK  (C)opyright 1990  Page - 6
  396.  
  397. Forth, create a batch file called JAIL which should be placed in the
  398. default directory. Following is example contents of this file:
  399.  
  400.    ECHO OFF
  401.    CD\GAP\JAIL
  402.    JAIL JAIL.CFG
  403.    BULLETIN BULLETIN.CFG
  404.    CD\GAP
  405.    GAP
  406.  
  407. the last line in the JAIL file should invoke the batch file which loads
  408. the GAP BBS system.
  409.  
  410. If this is a little unclear then please read your systems documentation for
  411. more detailed instructions.
  412.  
  413. If you use a door monitoring program then read their documentation for
  414. their specific setup.
  415.  
  416.  
  417. Spitfire Setup:
  418. ---------------
  419. First edit your SFDOOR.MNU and add the following line. If you are not running
  420. and doors at this time you will need to create this file.
  421.  
  422.    JAILBREAK, 10
  423.  
  424.    Where Soli-Tree is the name of the door to appear on your menu and the 10
  425.    is the lowest security level that will be allowed to enter the door. Don't
  426.    forget the comma (,) after the name.
  427.  
  428. Second create a sub-directory to place the door game in. In this example we
  429. will use 'C:\SF\DOOR_A' for the game directory.
  430.  
  431. Third move all the files in the JAIL.ZIP archive into this directory.
  432.  
  433. Forth edit your SF.BAT file adding the following lines.
  434.  
  435. :DOOR_A
  436.    CD\SF\DOORS_A
  437.    JAIL JAIL.CFG
  438.    BULLETIN BULLETIN.CFG
  439.    CD\SF
  440.    GOTO LOOP
  441.  
  442.  
  443. Fifth, rerun Sf.BAT and your ready to begin play.
  444.  
  445. If this is a little unclear then please read your systems documentation for
  446. more detailed instructions.
  447.  
  448. If you use a door monitoring program then read their documentation for
  449. their specific setup.
  450.  
  451.  
  452.  
  453. PCBoard 14.0+ Setup:
  454. --------------------
  455. First, edit your DOORS and DOORSG file so that it shows Jail Break with the door
  456. number relating to it's position in DOORS.DAT.
  457.  
  458. Second, edit the DOORS.DAT file so that it includes JAIL.
  459.  
  460.  
  461.                 JAIL BREAK (C)opyright 1990  Page - 7
  462.  
  463. Third, create a sub-directory for Soli-Tree to be placed in. And example
  464. would be:
  465.  
  466. C:\PCB\JAIL
  467.  
  468. place all the files in the JAIL.ZIP archive inside this directory.
  469.  
  470. Forth, create a batch file called JAIL which should be placed in the
  471. default directory. Following is example contents of this file:
  472.  
  473.    ECHO OFF
  474.    CD\PCB\JAIL
  475.    JAIL JAIL.CFG
  476.    BULLETIN BULLETIN.CFG
  477.    CD\PCB
  478.    BOARD
  479.  
  480. the last line in the JAIL file should invoke the batch file which loads
  481. the PCboard BBS system.
  482.  
  483. If this is a little unclear then please read your systems documentation for
  484. more detailed instructions.
  485.  
  486. If you use a door monitoring program then read their documentation for
  487. their specific setup.
  488.  
  489.  
  490. QuickBBS Setup:
  491. ---------------
  492. First, add the game to your games menu and select the correct type for doors.
  493.  
  494. Second, create a sub-directory for the game and move all the files from the
  495. zip file to this directory.
  496.  
  497. Third, the game reads the file DORINFOx.DEF. Where 'x' is the node number.
  498. Since QuickBBS only supports one node at this time then this file should be
  499. 'DORINFO1.DEF'. This file's drive\path\filename should be on the third line
  500. of the configuration file.
  501.  
  502.    Note: It was told to me that the upcoming 3.0 version of QucikBBS will
  503.          support Multi-Nodes and that the 'DORINFOx.DEF' will be changed
  504.          to 'DORINFxx.DEF' to support Multi-Nodes. This game is written
  505.          where you can specify this new name as well as any others.
  506.  
  507.  
  508. Forth, create a batch file called JAIL which should be placed in the
  509. default directory. Following is example contents of this file:
  510.  
  511.    ECHO OFF
  512.    CD\QUICKBBS\JAIL
  513.    JAIL JAIL.CFG
  514.    BULLETIN BULLETIN.CFG
  515.    CD\QUICKBBS
  516.    QBBS.BAT
  517.  
  518. the last line in the JAIL file should invoke the batch file which loads
  519. the QuickBBS system.
  520.  
  521. If this is a little unclear then please read your systems documentation for
  522. more detailed instructions.
  523.  
  524. If you use a door monitoring program then read their documentation for
  525. their specific setup.
  526.  
  527.               JAIL BREAK  (C)opyright 1990  Page - 8
  528.  
  529.                             Technical Support
  530.  
  531. If you have problems with the Multi-Board JAIL BREAK! live game you may
  532. contact Mike Wilson at the Secret Service BBS 24 hours per day.
  533. Also Node ID SECRET on PCRELAY Network and Node 1:262/29 on FIDO.
  534. (304)-429-6838
  535.  
  536.  
  537.  
  538.  
  539.                               Order Information
  540.  
  541.  
  542. Just mail $20.00 Check, Money Order or Cash to:
  543. Please include your board name with your order
  544. as you want it to appear within the program.
  545.  
  546. Mike Wilson
  547. P.O. Box 9521
  548. Huntington, WV
  549.             25704
  550.  
  551.  
  552.  
  553. Make Checks out to Mike Wilson.
  554.  
  555.  
  556. Thanks to Jeff Sumberg for some great C routines used in this program!
  557.  
  558.  
  559.  
  560.  
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.                          JAIL BREAK (C)opyright 1990 Page 9